Skip to content

RHIDP-13359: Lightspeed 1.10 changes#2210

Open
pabel-rh wants to merge 9 commits into
redhat-developer:mainfrom
pabel-rh:rhidp-13359
Open

RHIDP-13359: Lightspeed 1.10 changes#2210
pabel-rh wants to merge 9 commits into
redhat-developer:mainfrom
pabel-rh:rhidp-13359

Conversation

@pabel-rh
Copy link
Copy Markdown
Member

@pabel-rh pabel-rh commented May 18, 2026

IMPORTANT: Do Not Merge - To be merged by Docs Team Only

Version(s):
main, release-1.10
Issue:
RHIDP-13359
Preview:
Interacting with Red Hat Developer Lightspeed for Red Hat Developer Hub

@rhdh-bot
Copy link
Copy Markdown
Collaborator

rhdh-bot commented May 18, 2026

PR Build Results

Build passed -- 34/34 titles | 73s
Preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-2210/


Content Quality Assessment

CQA Report

  • CQA-00a: Orphaned modules
  • CQA-00b: Directory structure
  • CQA-01: Vale AsciiDoc DITA compliance
  • CQA-02: Verify assembly structure
  • CQA-03: Verify content type metadata
  • CQA-04: Verify module templates
  • CQA-05: Verify required modular elements
  • CQA-06: Verify assemblies follow official template (one user story)
  • CQA-07: Verify TOC depth (max 3 levels)
  • CQA-08: Verify short description content quality
  • CQA-09: Verify short description format
  • CQA-10: Verify titles are brief, complete, and descriptive
  • CQA-11: Verify procedure prerequisites
  • CQA-12: Verify grammar and style (Vale)
  • CQA-13: Verify content matches declared type
  • CQA-14: Verify no broken links
  • CQA-15: Check redirects
  • CQA-16: Verify official product names
  • CQA-17: Verify legal disclaimers for preview features

Summary

Checks: 19 total, 19 pass, 0 fail

19 checks: 19 pass, 0 fail

Run node build/scripts/cqa/index.js --all --fix locally to review and auto-fix issues.


Updated 2026-05-21 14:44:18 UTC

Comment thread assemblies/shared/assembly-appendix-manage-user-data-security.adoc
Comment thread assemblies/shared/assembly-configure-to-initialize-the-ai-assistant.adoc Outdated
Comment thread assemblies/shared/assembly-configure-to-initialize-the-ai-assistant.adoc Outdated
Comment thread assemblies/shared/assembly-customize-ai-responses.adoc
Comment thread assemblies/shared/assembly-customize-to-tailor-ai-responses.adoc Outdated
Comment thread assemblies/shared/assembly-appendix-llm-requirements.adoc Outdated
Comment thread assemblies/shared/assembly-customize-to-tailor-ai-responses.adoc Outdated
Comment thread modules/shared/con-architecture-for-your-ai-backend-deployment.adoc Outdated
Comment thread modules/shared/con-bring-your-own-model-integration.adoc Outdated
Comment thread modules/shared/con-in-air-gapped-environments.adoc Outdated
Comment thread modules/shared/proc-configure-by-using-the-helm-chart.adoc Outdated
Comment thread modules/shared/proc-configure-by-using-the-helm-chart.adoc
Comment thread modules/shared/proc-configure-by-using-the-helm-chart.adoc Outdated
Comment thread modules/shared/proc-configure-by-using-the-operator.adoc Outdated
Comment thread modules/shared/proc-configure-by-using-the-operator.adoc Outdated
@pabel-rh
Copy link
Copy Markdown
Member Author

Once this PR is merged, we need to uncomment this line in this:
https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/pull/2165/changes#r3279358697
cc: @jmagak

Comment thread modules/shared/con-vertex-ai-integration-for-scalable-model-deployment.adoc Outdated
* Ollama (popular desktop inference server)
* vLLM (popular enterprise inference server)
* Gemini (available through Vertex AI)
The underlying {lcs-short} service integrates with several platforms that support the OpenAI API specification or utilize the vLLM inference engine. Because there is no explicit {rhoai-brand-name} provider option in the configuration, you must route those deployments through the vLLM or OpenAI-compatible provider settings.
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Jdubrick , I have rewritten this to apply your change. Would you please take a look?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I think a snippet in addition to that where it lets the users know that as long as it is OpenAI compatible in its API schema then they should be able to use the vllm provider type since it really just looks for OpenAI compatible and then looks for /v1 at the end of the url, but I can't make any guarantees, I'm just speaking from experience with other hosted providers

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay! Do we need to run this by anyone else to verify the new line I'm adding as per your comment?
The new line -
"The vllm provider type communicates with endpoints that conform to the OpenAI API schema by automatically appending /v1 to the configured provider URL. This mechanism allows you to use the vllm configuration for other hosted, OpenAI-compliant inference providers."

:_mod-docs-content-type: CONCEPT

[id="ollama-model-integration-for-local-development-environments_{context}"]
= Ollama model integration for local development environments
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Jdubrick , I've changed this based on your comment. Would you please take a look?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I may have been confusing. You can use Ollama for cluster deployed environments if you want, you just need to make sure it is deployed in an environment that is accessible, if you just deployed it on localhost and tried to use it with a cluster deployed Lightspeed, it wouldn't work.

So:
Local Ollama + Local Lightspeed = good
Local Lightspeed + Cluster Ollama (if available externally from cluster) = good
Cluster Ollama + Cluster Lightspeed = good
Local Ollama + Cluster Lightspeed = bad

@@ -0,0 +1,26 @@
:_mod-docs-content-type: PROCEDURE
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@gabemontero , would you please verify this section?
I also need help with the script for skopeo copy. I've left it empty now.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you should work with the @redhat-developer/rhdh-install team on the skopeo copy script ... they can speak to it much more authoritatively on it than I can

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1, consulting the @redhat-developer/rhdh-install is probably the best to make sure we don't miss anything related to air-gapping / how it works with Helm/Operator

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've asked the RHDH-Install team to take a look.

Copy link
Copy Markdown
Contributor

@gabemontero gabemontero left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

of course tweak my wording as needed @pabel-rh
but it is essential that we are clean on the additional need wrt updating the install pull secret for the kubelet

Comment thread modules/shared/proc-mirror-images-for-air-gapped-environments.adoc
* Ollama (popular desktop inference server)
* vLLM (popular enterprise inference server)
* Gemini (available through Vertex AI)
The underlying {lcs-short} service integrates with several platforms that support the OpenAI API specification or utilize the vLLM inference engine. Because there is no explicit {rhoai-brand-name} provider option in the configuration, you must route those deployments through the vLLM or OpenAI-compatible provider settings.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I think a snippet in addition to that where it lets the users know that as long as it is OpenAI compatible in its API schema then they should be able to use the vllm provider type since it really just looks for OpenAI compatible and then looks for /v1 at the end of the url, but I can't make any guarantees, I'm just speaking from experience with other hosted providers

{ls-short} supports the following inference provider configurations:

* OpenAI cloud-based inference services
* vLLM enterprise inference servers, which includes models hosted on {rhoai-brand-name} and {rhel} AI
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Possibly here is where that explanation about it probably working via vllm for rhoai/rhelai

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not familiar enough with those 2 services, I think maybe @gabemontero or @johnmcollier would know more about their workings?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good to me

:_mod-docs-content-type: CONCEPT

[id="ollama-model-integration-for-local-development-environments_{context}"]
= Ollama model integration for local development environments
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I may have been confusing. You can use Ollama for cluster deployed environments if you want, you just need to make sure it is deployed in an environment that is accessible, if you just deployed it on localhost and tried to use it with a cluster deployed Lightspeed, it wouldn't work.

So:
Local Ollama + Local Lightspeed = good
Local Lightspeed + Cluster Ollama (if available externally from cluster) = good
Cluster Ollama + Cluster Lightspeed = good
Local Ollama + Cluster Lightspeed = bad

Comment thread modules/shared/con-vertex-ai-integration-for-scalable-model-deployment.adoc Outdated
Comment thread modules/shared/proc-customize-chat-history-storage.adoc Outdated
Comment thread modules/shared/snip-lightspeed-secret-keys.adoc
Comment thread modules/shared/snip-rbac-policies.adoc
Comment thread modules/shared/proc-configure-by-using-the-operator.adoc Outdated
@@ -0,0 +1,26 @@
:_mod-docs-content-type: PROCEDURE
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1, consulting the @redhat-developer/rhdh-install is probably the best to make sure we don't miss anything related to air-gapping / how it works with Helm/Operator

@sonarqubecloud
Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants